Button

Use the button to perform actions like opening windows, execute a script or set a tag value.

Buttons may be Active or Inactive. Active corresponds to the 'Pushed' state, and inactivate to the 'Idle' state. Different types of buttons will behave differently with the mouse events (see Button Property 'Type').

Create a Button

Open the destination window to add the Control.

From the Toolbox, select the Label icon, move the pointer into the window and drag the initial position and size for the control.

Access a Button properties

If the Property Editor is not displayed, click on RibbonHomeProperty Editor

Click on the Control. The Properties for the control will appear in the Property Editor panel and allow changes to be made.

Button Properties

Name: Name of the control

Alias: Alias of the control

General

Is Visible: controls the visibility of the button. Untick to hide this button.

Type:Can be one of;

Permissions: List of permissions required to action the button. Any mouse event on the button will be ignored unless the current user has all the selected permissions enabled.

See Users panel to define new permissions or edit the current ones.

Template: the template that may be used by this button. See "Templates"

 

Layout: Defines the layout parameters for the control

X: X location in the window to place the control

Y: Y location in the window to place the control

Width: Width of the control

Height: Height of the control

Anchor: Which edge of the window the control is anchored to when the window is resized. See "Anchors"

 

Visual: The Visual category allows the user to configure the look and feel of the control for both the Active and Inactive states.

General:

Text: Enter the Text to display in the button for the Acrive and Inactive state. Defaults to 'Active' for the Active state and 'Inactive' for the Inactive state.

Background:

Start Color: Select the background start color

End Color: Select the background end color

Gradient Mode: Select from one of the displayed Gradient modes

Image: Select from a list of Project images. See "Images"

Image Layout: Select from None, Tile or Stretch

 

Border:

Corner Radius: To produce rounded corners enter a Radius value. Defaults to 2.

Thickness: Enter the Border thickness. Defaults to 1

Color: Select the color of the text from the list of available colors defined in the project.

Dash Style: If the border needs to be dashed then select from one of the available dash styles

 

Shadow:

Color: If the Panel needs a drop shadow, select the color of the text from the list of available colors defined in the project.

Distance: distance for the drop shadow. Note that the shadow is produced behind the Panel, below and to the right by the specified distance.

 

Font:

Family: Select the Font family for the Number text. Defaults to Arial.

Size: Size for the Number text in points. Defaults to 10.

Style: Select from Regular, Bold, Italic, Underline or Strikeout. Defaults to Regular.

Alignment: Select from Left, Right or Center. Defaults to Right.

Color: Select the color of the number from the list of available colors defined in the project.

 

Actions: An action may be triggered when the button becomes active and inactive if the current users has all the required permissions. See "Actions"

On Active: Action to take when the Button is changed to Active. Defaults to (None) but can be selected from one of the System actions.

On Inactive: Action to take when the Button is changed to Inactive. Defaults to (None) but can be selected from one of the System actions.

 

Binding: The following properties of the Button may be bound to a tag

Active:

Active Text:

Active Background Color Start:

Active Background Color End:

Active Background Image:

Active Border Color:

Active Shadow Color:

Active Font Color:

Inactive Text

Inactive Background Color Start:

Inactive Background Color End:

Inactive Background Image:

Inactive Border Color:

Inactive Shadow Color:

Inactive Font Color:

Visible:

 

Event Log: Configure an Event Log entry for this control. See "Event Logs"